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Related Documents 

The following documents provide additional information: 

Documents Specific to HP Ultrium Drives 

■ Software Integration Guide, volume 2 of the HP Ultrium Technical 
Reference Manual 

■ The SCSI Interface, volume 3 of the HP Ultrium Technical Reference 
Manual 

■ Specifications, volume 4 of the HP Ultrium Technical Reference Manual 

■ HP Ultrium Configuration Guide, volume 5 of the HP Ultrium Technical 
Reference Manual 

■ Background to Ultrium Drives, volume 6 of the HP Ultrium Technical 
Reference Manual 

■ HP Ultrium Technology White Paper, which describes the features and 
benefits of HP Ultrium drives 

Please contact your HP supplier for copies. 

Documentation Map 

The following will help you locate information in the 6-volume Technical 
Reference Manual: 

Drives— general 



SCSI Drives FC Drives 



Connectors 1 HW Integration: ch. 7 1 HW Integration: ch. 4 
Controller architecture 6 Background: ch. 4 

Front Panel LEDs 1 HW Integration: ch. 6 1 HW Integration: ch. 3 
Mechanism and hardware 6 Background: ch. 3 

Specifications 4 Specs 

Installation and Configuration 



SCSI Drives FC Drives 



Connectors 1 HW Integration: ch. 7 1 HW Integration: ch. 4 



3 





SCSI Drives FC Drives 


Determining the configuration 


2 SW Integration: ch. 2 2 SW Integration: ch. 2 


External drives (SCSI only) 


1 HW Integration: ch. 5 n/a 


In Libraries 


1 HW Integration: ch. 1 


In Servers (SCSI only) 


1 HW Integration: ch. 4 n/a 


In Tape Arrays (SCSI only) 


1 HW Integration: ch. 3 n/a 


Modes of Usage (SCSI only) 


1 HW Integration: ch. 8 n/a 


Optimizing performance (SCSI only) 1 HW Integration: ch. 8 n/a 

2 SW Integration: ch. 4 


UNIX configuration 


5 UNIX Config 


Operation 
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External drives (SCSI only) 


1 HW Integration: ch. 5 n/a 


In Libraries 


1 HW Integration: ch. 1 


In Servers (SCSI only) 


1 HW Integration: ch. 4 n/a 


In Tape Arrays (SCSI only) 


1 HW Integration: ch. 3 n/a 


Cartridges 






SCSI Drives FC Drives 


Cartridge Memory (LTO-CM) 


2 SW Integration: ch. 5 
6 HW Integration: ch. 5 


Cartridges 


1 HW Integration: ch. 9 1 HW Integration: ch. 5 


Features 


6 HW Integration: ch. 5 


Managing the use of cartridges 


2 SW Integration: ch. 1 


Use of cartridges 


2 SW Integration: ch. 3 


Interface 




SCSI Guide 


3 SCSI 


Commands 


3 SCSI: ch. 4 


Error codes 1 HW Integration: ch. 10 1 HW Integration: ch. 6 


Implementation 


3 SCSI: ch. 1 


Interpreting sense data 


2 SW Integration: ch. 3 


Messages 


3 SCSI: ch. 2 
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Mode pages 

—see the MODE SENSE command 


3 SCSI: ch. 4 


Pre-execution checks 


3 SCSI: ch. 3 


Responding to Sense Keys and ASC/Q 


2 SW Integration: ch. 6 


Sense Keys and ASC/Q 

-see REQUEST SENSE command 


3 SCSI: ch. 4 


Maintenance and Troubleshooting 




SCSI Drives FC Drives 


Cleaning 


2 SW Integration: ch. 5 
2 SW Integration: ch. 7 


External drives (SCSI only) 


1 HW Integration: ch. 5 n/a 


In Libraries 


1 HW Integration: ch. 1 


In Servers (SCSI only) 


1 HW Integration: ch. 4 n/a 


In Tape Arrays (SCSI only) 


1 HW Integration: ch. 3 n/a 


Monitoring drive and tape condition 


2 SW Integration: ch. 7 


Software troubleshooting techniques 


2 SW Integration: ch. 1 


Dealing with Errors 




Error Codes 1 HW Integration: en. 10 1 HW Integration: ch. 6 


Handling errors 


2 SW Integration: ch. 5 


How error correction works 


6 Background: ch. 4 


Logs— see the LOG SENSE command 


3 SCSI: ch. 4 


Recovering from write and read errors 


2 SW Integration: ch. 7 


Software response to error correction 


2 SW Integration: ch. 3 


Software response to logs 


2 SW Integration: ch. 3 


TapeAlert log 


2 SW Integration: ch. 7 


Ultrium Features 






SCSI Drives FC Drives 


Adaptive Tape Speed (ATS) 


6 Background: ch. 1 


Autoload 


1 HW Integration: ch. 2 


Automation Control Interface (AG) 


1 HW Integration: ch. 2 
6 Background: ch. 1 
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Cartridge Memory (LTO-CM)s 


1 HW Integration: ch. 2 

r S\A/ Inton rntlr^n* i~n S 
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6 HW Integration: ch. 5 


Data Compression, how it works 


6 Background: ch. 5 


Data Compression, managing 


2 SW Integration: ch. 5 


Design principles 


6 Background: ch. 1 


OBDR and CD-ROM emulation 


6 Background: ch. 1 
2 SW Integration: ch. 7 


Performance optimization 


1 HW Integration: ch. 8 n/a 
2 SW Integration: ch. 1 


Performance, factors affecting 


2 SW Integration: ch. 4 


Software design 


2 SW Integration: ch. 1 


Supporting Ultrium features 


2 SW Integration: ch. 5 


Ultrium Format 


6 Background: ch. 2 



General Documents and Standardization 

■ For a general backgrounder on LTO technology and licensing, go to 
ht tp : / /www . 1 to- technology . com. 

■ Small Computer System Interface (SCSI-1 J, ANSI X3.1 31 -1986. This is the 
ANSI authorized standard for SCSI implementation, available through 
ANSI 

■ Enhanced Small Computer System Interface (SCSI-2), ANSI X3T9.2-1993 
Rev. 10L, available through ANSI 

■ Information Technology — SCSI Parallel lnterface-3 (SPI-3), T10 Project 
1302D, Working Draft Revision 14 

Copies of General Documents can be obtained from: 

ANSI 1 1 West 42nd Street 

New York, NY 10036-8002 
USA 

ISO CP 56 

CH-1211 Geneva 20 
Switzerland 
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ECMA 1 14 Rue du Rhone 
CH-1 204 Geneva 
Switzerland 

Global Engineering Documents 2805 McGaw 

Irvine, CA 92714 
USA 



Tel: +41 22 849 6000 

Web URL: http : / /www. ecma . ch 
Tel: 800 854 71 79 or 71 4 261 1 455 



7 



8 



A 



contents 



Related Documents 3 

Documents Specific to HP Ultrium Drives 3 

Documentation Map 3 

General Documents and Standardization 6 

1 Introduction 1 1 

The Purpose of this Manual 1 1 

Ultrium Drives in a Library 1 1 
Backup Applications 12 

2 HP-UX Systems 13 

HP Servers and Workstations- HP-UX 1 1 .x 13 

Introduction 13 

Determining the SCSI ID 13 

Creating the Device Files 15 
What Next? 18 

3 HP (Compaq) Tru64 UNIX 19 

HP (Compaq) Tru64 UNIX 5.x 19 
What Next? 20 

4 IBM(AIX) 21 

Determining the SCSI ID 21 
Configuring the Device Files 21 
Device Filenames under AIX 22 

5 Linux 25 

Determining the SCSI ID (Linux) 25 



Contents 9 



Configuring on Linux Systems 25 

Using the Seek and Tell Features of mt 27 
What Next? 27 

6 Sun Systems, Solaris (SunOS 5.x) 29 

Determining the SCSI ID 29 
Configuring the Device Files 30 
HP-Data Values 32 

7 Verifying the Installation 35 

Verifying the Installation of the Drive (UNIX) 35 
To verify the installation: 35 

Glossary 39 

Index 43 



1 0 Contents 



Introduction 




The Purpose of this Manual 



This manual provides basic information on configuring the drives with various 
operating systems. 

Please see the top-level release notes that accompany the drive for expected 
functionality and features. 

Ultrium drives are supported on the following platforms: 

■ HP UNIX systems (HP-UX) (Chapter 2) 

■ HP (Compaq) Tru64 UNIX (Chapter 3) 

■ IBM (AIX) (Chapter 4) 

■ Linux (Chapter 5) 

■ Sun Systems, Solaris 2 (SunOS 5.x) (Chapter 6) 

For platforms not mentioned here, please contact HP because there may be 
new connectivity details available that arrived after the release notes were 
published. 

See Chapter 7 for details of how to verify the installation. 



Ultrium drives may also be used in a library. However, instructions about 
installing device drivers for automatic robotics are not included in this 
manual. 



Ultrium Drives in a Library 
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Backup Applications 



For optimum performance it is important to use a backup application that 
supports the drive's features within your system's configuration. Please see the 
"Getting Started Guide" for more information about usage models. 

The following applications are suitable for use within an enterprise 
environment and have been tested with Ultrium drives. They use the operating 
system's standard, built-in device drivers, as described in this manual. For 
further information about optimizing performance and making full use of the 
drive's functions, please contact the software manufacturer or HP 





HP-UX 


AIX 


Sun, Solaris 


Linux 1 


HP Omniback 1 


yes 


yes 


yes 


yes 


Legato Networker 


yes 


yes 


yes 


yes 


Veritas NetBackup 


yes 


yes 


yes 


2 

yes 



1 . Cell Manager is only available on HP-UX or Windows 

2. Redhat Server only (not Caldera, Suse, and so on) 
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HP-UX Systems 



HP Servers and Workstations— HP-UX 11.x 

Note HP-UX 10.x is only supported by Generation 1 Ultrium drives. 

Introduction 

Before you install your tape drive log on to the HP web site, www . hp . com, 
and download the latest hardware enablement patch bundle for your 
operating system. This ensures that you will have the correct device driver for 
your tape drive. 

Determining the SCSI ID 

Before you configure your system to support your new HP Ultrium drive, you 
need to determine what SCSI ID to use. The SCSI ID must be unique for each 
device attached to the SCSI bus. To list the existing devices, use the following 
command: 

% /sbin/ioscan -f 

The output of this should look similar to the following example: 



Class 


I 


H/w Path 


Driver 


S/W State 


H/W Type 


Description 


be 


0 




root 


CLAIMED 


BUS NEXUS 




be 


1 


8 


be 


CLAIMED 


BUS NEXUS 


Psudo Bus Converter 


ba 


0 


8/0 


GSCtoPCI 


CLAIMED 


BUS NEXUS 


GSCtoPCI Bridge 


ext bus 


1 


8/0/2/0 


C720 


CLAIMED 


INTERFACE 


SCSI C895 Ultra2 Wide LVD 


target 


0 


8/0/2/0.7 


tgt 


CLAIMED 


DEVICE 




ctl 


1 


8/0/2/0.7. 


0 sctl 


CLAIMED 


DEVICE 


Initiator 


lan 


0 


8/0/20/0 


btlan3 


CLAIMED 


INTERFACE 


PCI (10110019) -- Built-in #1 


ba 


1 


8/16 


bus adapter 


CLAIMED 


BUS NEXUS 


Core I/O Adapter 


tty 


0 


8/16/4 


asioO 


CLAIMED 


INTERFACE 


Built-in RS-232C 


ext bus 


2 


8/16/5 


c720 


CLAIMED 


INTERFACE 


Built-in SCSI 
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target 1 8/16/5.5 tgt CLAIMED DEVICE 

disk 0 8/16/5.5.0 sdisk CLAIMED DEVICE SEAGATE ST34573N 

target 2 8/16/5.7 tgt CLAIMED DEVICE 

ctl 2 8/16/5.7.0 sctl CLAIMED DEVICE Initiator 

processor 0 62 processor CLAIMED PROCESSOR Processor 

memory 0 63 memory CLAIMED MEMORY Memory 



After you have installed the new tape drive, you can check that it has been 
attached successfully. From a shell window (hpterm/xterm), execute 
ioscan to display the list of attached devices. 

For an HP Ultrium drive, execute the following: 

% /sbin/ioscan -f | grep "Ultrium" 

The new lines should look similar to the following, where the 4 in the i field 
represents the instance of the SCSI tape driver, not the SCSI ID: 

tape 4 2/0/1.5.0 stape CLAIMED DEVICE HP Ultrium 



Note If you are installing the drive onto a Storage Area Network 

(SAN), the fibre channel/SCSI bridge will also appear in the 
list of attached devices. 

If you cannot find the Ultrium drive, this may be because the kernel does not 
contain the correct driver. Use the System Administration Manager (sam) to 
add stape to the kernel: 

To add stape to the kernel using sam: 

1 % sam 

2 Select the following: 

Kernel Configuration 
Drivers 

3 Highlight the stape driver. If the driver has not been added to the kernel, 
both Current State and Pending State will read "Out". 

4 Select the following: 

Act ions 

Add Driver to Kernel 
The Pending State will now read "In". 

5 To add the new driver to the kernel, select: 
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Actions 

Create a New Kernel 

6 The stape driver will now be added to the kernel and then the system will 
reboot. 

Creating the Device Files 

Once you have verified the tape drive connection, you will need to create the 
appropriate device files for the drive. Normally, you would have rebooted 
your system after attaching the tape drive, and this process runs insf . 
However, if you have not rebooted your system since attaching the drive, you 
can create device files by one of two ways, either through the System 
Administration Manager (sam), or by executing the mksf command. 

To add device files using sam: 

This is the recommended and simplest way to create device files. 

1 % sam 

This will bring up the graphical user interface for the utility. 

2 Select the following: 

Peripheral Devices 
Tape Drives 

sam will then scan the system for any tape drives connected. 
When an HP Ultrium drive is found, it will be displayed as: 

Hardware Path Driver Description 

8/0/2/0.3.0 stape HP Ultrium 1-SCSI 

8/0/2/0.4.0 stape HP Ultrium 2-SCSI 

3 Highlight the Ultrium drive and select the following from the tool bar: 

Act ions 

Create Device Files 

Create Default Device Files 

This will create default device files for the drive. To view the device files 
that have been created, select: 

Act ions 

Create Device Files 
Show Device Files 
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where: 



I Device File 


Description 1 


where < i > 


is the instance number of the drive 


< I >m 

< I >mn 

< I >mb 
< I >mnb 


AT&T encoding, rewind driver 
AT&T encoding, non-rewind driver 
Berkeley encoding, rewind driver 
Berkeley encoding, rewind driver 


where <x> 

<Y> 
<Z> 


is the card number 
is the target number 
is the LUN number 


cXt YbZBEST 
cXt YbZBESTb 


Best compression driver, AT&T encoding, with rewind 
Best compression driver, Berkeley encoding, with rewind 



cXtYbZBESTn Best compression driver, AT&T encoding, non-rewind 
cxtYbZBESTnb Best compression driver, Berkeley encoding, non-rewind 

4 When you have exited sam, run ioscan to see the tape drive: 

%/sbin/ioscan -C tape - f n 

To create device files using mksf : 

Note This method is not recommended. 

1 Run insf as follows: 

% /sbin/insf -C tape 

2 Create the device files for the devices using the mksf command as 
follows: 



% /sbin/mksf -d stape -I <instance> [-n] [-u] /dev/ 
rmt/X<name> 

where: 



Argument 


Description 1 


-d stape 


Specifies the SCSI tape driver 


-I <instance> 


Specifies the tape drive's hardware address via the instance of the SCSI tape 
driver. The first instance is 0, the second 1, and so on. 


[-n] 


Specifies no rewind; absence of this parameter indicates rewind mode 
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Argument Description 



[ -u] Specifies Berkeley mode; absence of this parameter indicates AT&T mode. 

Berkeley and AT&T modes differ in their read-only close behavior: 

■ In Berkeley mode, the tape position will remain unchanged by a device 
close operation. 

■ In AT&T mode, a device close operation will cause the tape to be 
repositioned just after the next tape filemark (the start of the next file). 

In most cases, Berkeley mode should be used. 

/dev/ rmt/x<name> Specifies the path of the device file, where: 

x Specifies the tape device identifier. Use the next available 

identifier. You can examine the contents of /dev/rmt using the is 
command to determine which identifiers have already been used. 

<name> Specifies the short name (in HP-UX 9.x-style) of the device file: 



mnb 


No 


rewind, 


compression disabled, Berkeley-mode 


device 


hnb 


No 


rewind, 


compression disabled, Berkeley-mode 


device 


mnb 


No 


rewind, 


compression disabled, Berkeley-mode 


device 


hnb 


No 


rewind, 


compression enabled, Berkeley-mode 


device 



See the man page (man im mksf ) for other options of the mksf command. 
The stape section covers the SCSI tape driver options. The man page man i 
mt describes the long filenames used in HP-UX 10.x and later. 

Example: 

To create a device file with the following characteristics: 

■ A hardware address specified by instance 5 ( - 1 5) 

■ No rewind (-n) 

■ Berkeley mode tape positioning on close (-u) 

■ A filename of 4mnb, where 4 is the tape device identifier (/dev/rmt/ 
4mnb) 

You would execute the following: 

% /sbin/mksf -d stape -I 4 -n -u /dev/rmt/4mnb 

You can check that the appropriate device file was created using the lssf 
command as follows: 

% /sbin/lssf /dev/rmt/4mnb 
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This should produce the following output to show that the device file now 
exists: 

stape card instance 0 SCSI target 6 SCSI LUN 0 berkeley no rewind 
BEST density at address 2/0/1.6.0 /dev/rmt/4mnb 

To create a device file for Ultrium in uncompressed mode, you should use a 
command such as: 

mksf -H -a -b U_18 
and for compressed mode (default): 

mksf -H -a -b U_18C 
The hardware path can be found from previous ioscan output. 



What Next? 

Once the device files have been created, you should confirm that your new 
tape drive is working properly. Chapter 7, "Verifying the Installation" 
provides instructions on backing up and restoring a sample file to test your 
installation. 
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HP (Compaq) Tru64 UNIX 



HP (Compaq) Tru64 UNIX S.x 



1 Add the following entry to your /dev/ddr . dbase file: 



SCSIDEVICE 

Type = tape 

Name = "HP" "Ultrium" 

# 

PARAMETERS : 

TypeSubClass 

BlockSize 

TagQueueDepth 

MaxTr ans f e r S i z e 

Re adyTime Seconds 

SyncTransf ers 

WideTransf ers 

InquiryLength 
DENSITY : 

DensityNumber 

OneFileMarkOnClose = 

DensityCode 

Blocking 

CompressionCode 

Buffered 

Speed 
MODESELECT : 

ModeSelectNumber 

SavePage 

PageFormat 

BlockDe script or 

Trans ferLength 

Hdr . Tape . Buff erMode = 

Hdr . MediumType 

Data .UBYTE [0] 

Data .UBYTE [1] 



# Linear Tape Open 



16Mb - 1 
Seconds 



lto 

262144 
0 

Oxf f f f f f 
120 

enabled 
enabled 
0x20 



0,1,2,3,4,5,6,7 
yes 
0x42 
0 
1 
1 
0 

0 

No 

scsi2 
yes 
16 
= 0x1 
0 

0x3D # Vendor Unique Page Code 3D 
0x02 
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Data .UBYTE [2] = 0x01 

Data .UBYTE [3] = 0x00 

2 Rebuild the kernel by running /sbin/ddr_conf ig, then reboot the 
system with the tape drive attached. The device files for the Ultrium drive 
will be generated in /dev/tape and /dev/ntape when you reboot. 

3 The names of the device files can be interpreted as follows: 

Devices in the /dev/ntape directory are "no-rewind" devices. Those in 
/dev/tape will do a rewind on close. 

The device files then have the syntax: tapex_dn 

For example, /dev/ntape/tape66_di is a device file for device 66, 
no-rewind using density number 1 . Since all density numbers have the 
same parameters it does not matter which density number file is used. 

What Next? 

Once the device files have been created, you should confirm that your new 
tape drive is working properly. Chapter 7, "Verifying the Installation" 
provides instructions on backing up and restoring a sample file to test your 
installation. 
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IBM (AIX) 



Determining the SCSI ID 

Before you configure your system to support your Ultrium drive, you need to 
determine which SCSI ID to use. IDs must be unique for each device attached 
to the SCSI bus. To list the existing devices, use the following command: 

% lsdev -C | grep SCSI 

This will produce output that looks similar to: 

scsiO Available 00-00-OS Standard SCSI I/O Controller 
hdiskO Available OO-OO-OS-0 1.0 GB SCSI Disk Drive 
rmtl Defined 00-00-0S-2,0 Other SCSI Tape Drive 

The SCSI ID is in the series oo-oo-os-z, o, where x is the SCSI ID. Review 
the list of existing SCSI IDs and choose an available ID to assign to the new 
tape drive. 



Configuring the Device Files 

To install an HP Ultrium drive on an IBM workstation you will need to create 
the appropriate device files for the drive. 

Note Do not choose the smit option of "4 mm2gb" as the Tape 

Device Type. This is reserved for Connor drives. If you use it 
with HP drives, you will get the error "Device to be 
configured does not match the physical device 
at the specified connection location". 

To change to variable block mode, use the following procedure: 

1 If you are using a graphics terminal running X-Windows, then at a 
Windows terminal, type: smit tape 
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If you are using a non-graphics terminal, at the command line type: 

% srait -C tape 

2 If no device has been configured at this address before, select "add a 
tape drive" to set up the address. From the pop-up window, select 
"ost" or "other scsi tape drive" as the tape drive you wish to 
change and choose connection addresses as appropriate. 

3 Select from the window: "change /show characteristics of a 
tape drive" 

4 From the pop-up window, select "ost" or "other scsi tape drive" 
as the tape drive you wish to change. Do not choose "4mm2gb". 

5 Change the block size field to 0, and click on the "do" button or press 
[Enter] to apply the change. 

HP Ultrium drives will work with tar, cpio, backup, restore and dd. For 
systems other than the 43P, the drive is also boot-capable, provided a boot 
tape is generated using mkszf ile and mksysb. 

Once the device files have been created, you should confirm that your new 
tape drive is working properly. Chapter 7, "Verifying the Installation" 
provides instructions on backing up and restoring a sample file to test your 
installation. 

Device Filenames under AIX 

Use device filenames as listed below for the combination of Rewind on Close, 



Retension on Open 


, and Compression 


that you want: 




Filename 


Rewind on Close 


Retension on Open 


Compression 1 


/ dev/rmtn 


Yes 


No 


enabled 


/ dev/rmtn . 1 


No 


No 


enabled 


/ dev/rmtn . 2 


Yes 


Yes 


enabled 


/dev/rmtn . 3 


No 


Yes 


enabled 


/ dev/rmtn . 4 


Yes 


No 


disabled 


/ dev/rmtn . 5 


No 


No 


disabled 


/ dev/rmtn . 6 


Yes 


Yes 


disabled 


/ dev/rmtn . 7 


No 


Yes 


disabled 
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The n in the filename is the instance number assigned to the drive by the 
operating system, where 0 is the first device, 1 is the second and so on. 

Rewind on Close Normally, the drive repositions the tape to BOT (Beginning of Tape) when the 
device file is closed. Using the no rewind option is useful when creating and 
reading tapes that contain multiple files. 

Retension on Open Retensioning consists of winding to EOT (End of Tape) and then rewinding to 
BOT, in order to reduce errors. If this option is selected, the tape is positioned 
at BOT as part of the open process. 

Compression Compression can be disabled or enabled. 
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Linux 



Determining the SCSI ID (Linux) 

Look at the output of dmesg to find out what SCSI channel number is used for 
each connection. 

To find out the SCSI IDs in use on each channel, type: 

cat /proc / scs i/ scsi 
This will produce output similar to the following for each device: 

Attached Devices 

Host: SCSIO Channel: 00 ld:00 Lun : 0 0 

Vendor: HP Model 

Type: Direct-Access ANSI SCSI Revision 02 

Look at the ID information to establish which IDs are in use. 



Configuring on Linux Systems 

No changes are needed to support Ultrium on Linux platforms, however you 
should ensure that you have the relevant drivers loaded. 

To see the device drivers loaded currently, execute an lsmod command, this 
will give output like: 

Module Size Used by 

sgm 4376 1 

ide-scsi 7200 0 

lockd 30792 1 

sunrpc 53316 1 

st 24656 0 

ncr53c8xx 52096 1 

aic7xxx 136184 2 
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The lines of interest here are: 

st This is the tape driver. Its presence in the output of the lsmod 
command shows that the tape driver is loaded. 
ncr53c8xx This is a SCSI chipset driver for the LSI Logic family of HBAs 
(amongst others). 

aic7xxx This is a SCSI chipset driver for the Adaptec 7xxx chipset 
family (such as Adaptec 29160LP). 

Latest SCSI controller drivers for Linux will be available from the 
manufacturer's web site. 

In order to communicate with a tape device, the operating system needs to 
have drivers for the tape and the underlying transport mechanism (the host 
bus adaptor) loaded. Ensure that both are available as either loadable 
modules (for example, usable with insmod and visible with lsmod) or are 
statically built into your kernel. 

Note In order to add drivers to the statically built kernel you need the 

Linux source code available on disk and knowledge of how to 
use the kernel building tools that ship with various Linux 
distributions. This should not be attempted by novice users. 

In order to determine if the drive has been detected by the tape driver at 
module load time, execute: 

dmesg | grep "st" 

This should find a number of lines. One should look like: 

Detected SCSI tape stO at scsil, channel 0, id 5, lun 0 

To load the tape driver module if it is not loaded as above, execute: 

insmod st 

to load it. This should happen naturally if your system is rebooted after 
attaching the drive. 

When the st driver module has been added, a list of tape device files will be 
created automatically. They reside in the /dev/ directory and have the 
syntax: 

/dev/stp or dev/nstp 

where: 

P is the instance number of the device file. (If only one drive is 
connected to the system, this will be 0.) 

n indicates that this is a no-rewind driver. 
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In order to enable large transfers under Linux (>64 KB per write), edit the file 

/usr/src/ 1 inux/ drivers / scs i / s t_opt ions . h and change the 
definition of st_buffer_blocks. 

If you want requests to space to end of data to be faster, you should also 
enable st_fast_mteom in the same file. After changing this file, rebuild the 
modules and install the new binary. At the very least, this requires: 

make modules 

make modules_install 

from the /usr/src/linux directory. See your kernel documentation. 

Using the Seek and Tell Features of mt 

In order to use the seek and tell features of mt, you must tell the st driver that 
HP Ultrium drives use logical block addressing. 

You can do this by using the command: 

mt -f <device file> stsetoptions scsi21ogical 
where /dev/stp is the device file. 

Note however that this information is not preserved across reboots, so you 
need to execute this command each time the system comes up. The stinit 
utility offers a convenient way of handling this; see the relevant man page for 
more information. If you use this approach, set the manufacturer parameter to 
hp and the model to "ultrium 2-scsi". 



What Next? 

Once the device files have been created, you should confirm that your new 
tape drive is working properly. Chapter 7, "Verifying the Installation" 
provides instructions on backing up and restoring a sample file to test your 
installation. 
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Sun Systems, Solaris 
(SunOS 5.a) 



Determining the SCSI ID 

Before you configure your system to support an HP Ultrium drive, you need to 
determine which SCSI ID to use. IDs must be unique for each device on 
attached to the SCSI bus. 

1 Use the modinf o command to identify SCSI controller drivers installed 
on the system. 

— For FAS or ESP devices: 

% modinfo | grep "SCSI Host" 

This will produce output similar to the following: 

18 501a4000 c3b8 61 1 esp (ESP SCSI Host Bus Adapter Drive) 
21 501C8000 9e70 6 1 fas (FAS SCSI Host Bus Adapter Drive) 

This indicates that there are two SCSI controllers on the system, an ESP- 
based adapter and a FAS-based adapter. For the adapter to which the 
new tape drive is attached, you will need to determine what SCSI IDs 
are already used. 

— For newer LSI/lntraserver LVD SCSI controllers: 

% modinfo | grep " Inter server " 

This will produce output similar to the following: 

100 78054000 11898 207 1 ithps ( ITHPS - 5 . 0 2 . 0 0 Intraserver) 
100 78054000 11898 207 1 ithps ( ITHPS - 5 . 0 2 . 0 0 Intraserver) 

2 Determine the SCSI IDs of the existing devices attached to the SCSI 
controller: 

For all adapters: 

% dmesg | egrep " . *xxx . *target " | sort | uniq 
where xxx = the type of adapter (esp, glm, fas or isp), as appropriate. 
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For example, for an ESP-based adapter: 

% dmesg | egrep ".* esp .* target " | sort | uniq 
This produces a list similar to: 

sdO at espO : target 0 lun 0 sd6 at espO : target 6 lun 0 

This indicates that SCSI IDs 0 and 6 are used for existing devices. SCSI ID 
7 is generally used for the adapter itself. In this situation, you would use a 
SCSI ID from 1 to 5 for the new tape drive. 



Configuring the Device Files 

Determine the device file by typing: 

% Is -1 /dev/rmt/*m | grep " st@X" 

where x is the SCSI ID. Identify the line for the tape drive. For example, if the 
drive was at SCSI ID 2, look for the line containing "st@2 , o". This might be 
as follows (but on a single line): 

lrwxrwxrwx 1 root root 63 Mar 1 00:00 /dev/rmt / 0m 
. . I . . /devices/sbus@lf , 0/espdma@e, 84 0 0 0 0 0 /espOe , 
8800000/st@2 , 0 :m 

Here you could use /dev/rmt/om (shown underlined above) as the device 
file. 

Only if necessary, make the following file modifications to enhance 
performance: 

1 In the file /kernel/drv/st . conf , after these lines: 

######## 

# Copyright (c) 1992, by Sun Microsystems, Inc. 
#ident "@ (#) St . conf 1.6 93/05/03 SMI" 

add the following depending on which drive you are installing (there are 
6 significant spaces between HP and Ultrium in line 2): 

for Solaris 2.7, 5.7 and 8: 

tape - conf ig- 1 i st = 
"HP Ultrium", "HP Ultrium LTO 1", " HP_LTO_GEN_l " , 

HP_LTO_GEN_l = 1 , 0x36 , 0 , 0xd639 , 4 , 0x00 , 0x00 , 0x00 , 0x40 , 3 ; 

"HP Ultrium 2", "HP Ultrium LTO 2 " , " HP_LTO_GEN_2 " ; 

HP_LTO_GEN_2 = 1 , 0x3 6 , 0 , 0xd6 3 9 , 4 , 0x0 0 , 0x0 0 , 0x0 0 , 0x4 2 , 3 ; 
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name="st" class="scsi" 
target=X lun=0; 

for Solaris 9: 

tape - conf ig - 1 i s t = 

"HP Ultrium 1", "HP Ultrium LTO 1", " HP_LT0_GEN_1 " , 

HP_LT0_GEN_1 =,0x3B, 0,0x18659, 4, 0x4 0, 0x4 0, 0x4 0 , 0x4 0,3, 60,300, 600, 1200, 600, 600, 18000; 
"HP Ultrium 2", "HP Ultrium LTO 2 " , " HP_LTO_GEN_2 " ; 

HP_LTO_GEN_2 = ,0x3B,0, 0x18659, 4, 0x4 2, 0x4 2, 0x4 2, 0x4 2, 3, 60, 300, 600, 1200, 600, 600, 18000 ; 

name="st" class="scsi" 
target=X lun=0; 

where x is the SCSI target address of the device you have attached. 

See "HP-Data Values" on page 32 below for the values of the parameters 
in these lines. 

2 If you are replacing an existing tape device on the same SCSI ID, remove 
the contents of the /dev/rmt directory as follows: 

% cd / dev/ rmt 
% rm * 

3 Do a reconfigure boot: 

% cd / 

% touch /reconfigure 
% sync; halt 

4 When the system is down, reboot: 

% boot -r 

Make sure you include the -r switch, so that the device directory is 
reconfigured using the new data. 

5 You should now be able to use the drive. 

— Use /dev/rmt/xcb if you require a compression rewind device file, 
where x is the relevant device address. 

— Use /dev/rmt/Xcbn when you require a compression non-rewind 
device. 

Once the device files have been created, you should confirm that your new 
tape drive is working properly. Chapter 7, "Verifying the Installation" 
provides instructions on backing up and restoring a sample file to test your 
installation. 
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HP-Data Values 



The values for hp_lto_gen_h and name, which provide normal LTO mode, 
have the following meanings: 

The syntax for hp_lto_gen_i and hp_lto_gen_2 on Solaris 8 or earlier 
is: 

<drive type> = <version>, <type>, <bsize>, <options>, 
<no . of densities>, <density 0>, <density 1>, 
<density 2>,<density 3>, <default density> 

The syntax for hp_lto_gen_i and hp_lto_gen_2 on Solaris 9 is: 

<drive type> = <version>, <type>, <bsize>, <options>, 
<no . of densities>, <density 0>, <density 1>, 
<density 2>,<density 3>, <default density>, 
<non-motion timeout>, <read/write timeout>, 
<rewind timeout>, <space timeout>, <load timeout>, 
<unload timeout>, <erase timeout> 

where: 



Parameter 


Value 


Meaning 




<version> 


l 


Indicates that this is the first version. 




< t yp e > 


0x36 


The value for an Ultrium drive in /usr/include/sys/mtio . 
indicates a type of mt isother, in other words not any of the 
such as dat or dlt. 


h. This 
default types 


<bsize> 


0 


Indicates variable block size. 





<options> 



0xd639 This value is derived from constants provided in /usr/include/sys/ 
scsi/targets/stdef . h. The value determines which operations the 
driver can perform with the attached device by using a unique value for each 
feature and then adding them together to form 0x6 3 9. The features are as 
follows: 



Oxooi Device supports variable length records. 

0x008 Device can backspace over files (as in the 'mt bsf ' option). 

Oxoio Device supports backspace record (as in 'mt bsr'). 

0x02 0 Solaris 8 and earlier only: Device requires a long time-out period 
for erase functions. 

0x040 Solaris 9 only: Device will automatically determinethe tape 
density. 
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Parameter Value 



Meaning 



0x02 0 0 Device knows when end of data has been reached. 

0x0400 Device driver is unloadable. 

Oxiooo Time-outs five times longer than normal. 

0x4 o o o Driver buffers write requests and pre-acknowledges success to 
application. 

0x8 0 0 0 Variable record size not limited to 64 KB. 

Oxioooo Solaris 9 only: Device determines which of the two mode pages 
the device supports for selecting or deselecting compression. 

So 0xd6 3 9 indicates variable record length, bsf and bsr enabled, long 
timeouts for erase, EOD recognition, Unloadable device driver, 5 x longer 
timeouts, buffer writes and pre-acknowledge sucess, variable records not 
limited to 64 KB, and, for Solaris 9 only: auto-density over-ride and MODE 
SELECT compression. 



<no. of 
densit ies > 


4 


There are four densities following in the parameter list. 


<density n> 


0x00 


Creates a device file with compression disabled. 


<density 3> 


0x4 0 or 

0x42 


The density code for data compression enabled by default. 


<def ault 
density> 


3 


Density 3 (0x42) is the default for Generation 2 drives. 


<X timeout> 




All timeouts are in seconds 



Values for the parameters for name are as follows: 



Parameter 


Value 


Meaning 


target 


X 


x specifies the SCSI ID (target) of the device. 


lun 


0 


Specifies the LUN for the device. 
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Verifying the Installation 



Verifying the Installation of the Drive (UNIX) 

As part of the installation process, you will have installed the appropriate 
device driver for your UNIX system, and created device files to communicate 
with the tape drive. 

This section describes how you can verify that the installation has been 
performed correctly. 

In outline, the procedure is as follows: 

1 Check the tape drive responds to a rewind command. 

2 Write test data to a tape. 

3 Read the test data from the tape. 

4 Compare the data read from the tape with the original data on disk. 

To verify the installation: 

1 Test the SCSI connection to the tape drive by doing a rewind operation: 
a If there is a tape cartridge already in the drive, remove it. 
b Insert a tape cartridge. 

c Rewind the tape using the command line: 

% mt -f <device file> rewind 

For example, on HP-UX: 

% mt -f /dev/rmt/Omnb rewind 

If the command completes successfully, there will be no feedback. If it 
fails, you will see an error message on the console. The hardware 
installation may be faulty. Check the troubleshooting section of the User's 
Guide for help in identifying the problem. 
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4 Write a sample file to tape, using 'tar': 

% cd / 

% tar cvf <device file> <file> 
The options to tar have the following meanings: 

c Create a new archive (backup file) on the device. 

v Operate in verbose mode. 

f Specify the device file explicitly. 

The arguments follow the cvf options in the command line. Their values 
depend on the operating system; suggested values are given the 
appropriate operating system chapter.The arguments are as follows: 

<device file> The name of the device file for the drive. 
Example: /dev/rmt/Om 

<f ile> The name of the file to archive, prefixed with ' . /'. 
Example: . /stand/vmunix 

Note Make sure you prefix the file name with ' .' when you back it up 

to tape. If you do not, the restore operation in step 3 will 
overwrite the original copy on disk. 

5 Read the file back from tape: 

% cd / tmp 

% tar xvf <device file> 
The 'x' option to tar here means "extract from the archive". 
Use the same value for the <device f ile> argument as in step 2. 

6 Compare the original with this retrieved file: 

% cmp <original file> /tmp/<retrieved file> 

This step compares the retrieved file and the original file byte by byte. If 
they are the same, there should be no output, and this verifies that the 
installation is correct. The arguments are as follows: 

<original f ile> The name of the original file, prefixed with '/'. 
Example: /stand/vmunix 

<retrieved file> The name of the file retrieved from the archive. 
Example: stand/vmunix 
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Example: 

Suppose you are verifying the installation of an HP Ultrium tape drive on an 
HP-UX 10.X system. The procedure would be as follows.: 

1 Change directory to root: 

% cd / 

2 Back up /stand/vmunix to tape: 

% tar cvf /dev/rmt/Om ./stand/vmunix 
Note the prefix of ' . ' to the filename. 

3 Change to the temporary directory: 

% cd /tmp 

4 Extract the file from the tape: 

% tar xvf /dev/rmt/Om 

5 Compare the original with the restored version: 

% cmp /stand/vmunix /tmp/stand/vmunix 
Note that the original filename is not prefixed with ' . '. 
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glossary 



AT&T mode Berkeley and AT&T functional modes differ in "read-only" close functionality. 

In AT&T mode, a device close operation will cause the tape to be repositioned 
just after next filemark on the tape (the start of the next file). 

Berkeley mode Berkeley and AT&T functional modes differ in "read-only" close functionality. 

In Berkeley mode the tape position will remain unchanged by a device close 
operation. 

BOT Beginning Of Tape. The first point on the tape that can be accessed by the 
drive. 

buffered mode A mode of data transfer in write operations that facilitates tape streaming. It is 
selected by setting the Buffered Mode Field to 1 in the SCSI MODE SELECT 
Parameter List header. 

compression A procedure in which data is transformed by the removal of redundant 

information in order to reduce the number of bits required to represent the 
data. This is basically done by representing strings of bytes with codewords. 

In Ultrium drives, the data is compressed using the LTO-DC compression 
format which is based on ALDC (licensed from Stac/IBM) with two 
enhancements. One limits the increase in size of data that cannot be 
compressed that ALDC produces. The other is the use of embedded 
codewords. 

data transfer phase On a SCSI bus, devices put in requests to be able to transfer information. 

Once a device is granted its request, it and the target to which it wants to 
send information can transfer the data using one of three protocols (assuming 
both devices support them): asynchronous, synchronous, and wide. 

In asynchronous transfers, the target controls the flow of data. The initiator 
can only send data when the target has acknowledged receipt of the previous 
packet. All SCSI devices must support asynchronous transfer. 
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In synchronous data transfer, the initiator and target work in synchronization, 
allowing transmission of a packet of data to start before acknowledgment of 
the previous transmission. 

In wide (16-bit) data transfer, two bytes are transferred at the same time 
instead of a single byte. 

HP Ultrium drives support asynchronous, synchronous and narrow (8-bit) 
wide transfers. 

fibre channel Fibre Channel provides an inexpensive yet expendable means of quickly 
transferring data between workstations, mainframes, supercomputers, 
desktop computers, storage devices, displays and other peripherials. 
Although it is called Fibre Channel, its architecture represents neither a 
channel nor a real network topology. It allows for an active intelligent 
interconnection scheme, called a fabric, to connect devices. All a Fibre 
Channel port has to do is to manage a simple point-to-point connection 
between itself and the fabric. The most prominent Fibre Channel standard is 
Fibre Channel Arbitrated Loop (FC-AL). 

Several common ULPs (Upper Level Protocols) including IP and SCSI can run 
on Fibre Channel, merging high-speed I/O (up to 2 Gb/s) and network 
functionality in a single connectivity technology. 

filemark A mark written by the host to the tape that can be searched for, often using 
the drive's fast-search capability. It does not necessarily separate files. It is up 
to the host to assign a meaning to the mark. 

immediate mode A mode of responding to SCSI commands where the drive or other peripheral 
does not wait until the command has finished before returning status 
information back to the host. For writing filemarks, Immediate mode can 
significantly improve the performance of systems that do not set the 
Immediate bit when sending a SCSI WRITE FILEMARKS command. On the 
other hand, data is not flushed to tape in response to a filemark command. 

infinite flush By default, the buffer in the drive is flushed every 5 seconds. Infinite flush 
avoids frequent starting and stopping of the mechanism when using a very 
slow application. It also avoids losing capacity through the flushing of partly 
written groups. On the other hand, infinite flush means that data can remain 
in the buffer for very long periods of time, and could be lost in the event of a 
power failure. 

LUN Logical Unit Number. A unique number by which a device is identified on the 
SCSI bus. A tape drive has a fixed LUN of 0. In an autoloader, the changer 
mechanism is LUN1 . 
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SAN Storage Area Network. A dedicated, high-speed network that establishes a 
direct connection between storage elements and servers. The hardware that 
connects workstations and servers to storage devices in a SAN is referred to 
as a fabric. The SAN fabric enables any-server-to-any-storage device 
connectivity through the use of Fibre Channel switching technology. 

SCSI Small Computer System Interface— a standard command specification and 
command set that enables computers and peripherals to communicate with 
each other. HP's Ultrium drives adhere to the SCSI-3 specification and 
support all features required by that standard. 

Single-Ended and Low Voltage Differential SCSI 

These terms define how the signals are transmitted along the cable. 

With single-ended (SE) SCSI, each signal travels over a single wire and each 
signal's value is determined by comparing the signal to a paired ground wire. 
Signal quality tends to decrease over longer cable lengths or at increased 
signal speed. 

With low voltage differential (LVD) signaling, signals travel along two wires 
and the difference in voltage between the wire pairs determines the signal 
value. This enables faster data rates and longer cabling with less susceptibility 
to noise than SE signaling and reduced power consumption. 

Narrow and Wide, Fast, Ultra and Ultra2 SCSI 

Narrow SCSI devices can transfer data one byte at-a-time (and are 
sometimes called "8-bit SCSI" devices). They can conform to either the SCSI-2 
or SCSI-3 protocols. They have a 50-pin connection to the SCSI bus. 

Wide SCSI devices can transfer two bytes of data simultaneously ("16-bit 
SCSI"). They usually have a single, 68-pin connection to the SCSI bus. (This 
physical arrangement is part of the SCSI-3 specification.) They may support 
either SCSI-2 or SCSI-3 protocols. Wide and narrow devices can 
simultaneously be connected to the same bus without problem, provided 
certain rules are followed. 

Fast SCSI can transfer data at up to 10 MB/sec, using a cable of up to 6 
meters total length. >/dd> 

Ultra SCSI can transfer data at up to 20 MB/sec, but the cable length cannot 
exceed 3 meters (it is also known as "Fast20"). 

Ultra2 SCSI can transfer data at up to 40 MB/sec, using a cable of up to 25 
meters total length for a single device, or up to 12 meters for two or more 
devices (it is also known as "Fast40"). 
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Ultra SCSI supports both SE and LVD interfaces. Ultra2 SCSI supports LVD 
interfaces only. In normal situations, slower devices can coexist with faster 
devices, and narrow devices can be used on the same SCSI bus as wide 
devices using a suitable adapter. 

HP's Ultrium drives are Ultra2, wide SCSI-3 compatible devices. They can be 
used with both LVD and SE host bus adapters. 

sequential access Sequential access devices store data sequentially in the order in which it is 
received. Tape devices are the most common sequential access devices. 
Devices such as disk drives are direct access devices, where data is stored in 
blocks, not necessarily sequentially. Direct access allows for speed of 
retrieval, but is significantly more costly. 
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